home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / misc / o-z / x-windows / fig2dev / fig2dev.man < prev    next >
Encoding:
Text File  |  1995-10-05  |  20.0 KB  |  529 lines
  1.  
  2.  
  3.  
  4.      FIG2DEV(1)                                             FIG2DEV(1)
  5.  
  6.  
  7.      NNAAMMEE
  8.           fig2dev - translates Fig code to various graphics languages
  9.  
  10.  
  11.      SSYYNNOOPPSSIISS
  12.           ffiigg22ddeevv  --LL  _l_a_n_g_u_a_g_e  [ --mm _m_a_g ] [ --ff _f_o_n_t ] [ --ss _f_s_i_z_e ] [
  13.           _o_t_h_e_r _o_p_t_i_o_n_s ] [ _f_i_g_-_f_i_l_e [ _o_u_t_-_f_i_l_e ] ]
  14.  
  15.  
  16.      DDEESSCCRRIIPPTTIIOONN
  17.           _F_i_g_2_d_e_v translates fig code in the named _f_i_g_-_f_i_l_e  into  the
  18.           specified  graphics _l_a_n_g_u_a_g_e and puts them in _o_u_t_-_f_i_l_e_.  The
  19.           default _f_i_g_-_f_i_l_e and _o_u_t_-_f_i_l_e are standard input  and  stan-
  20.           dard output, respectively
  21.  
  22.           Fig  (Facility  for  Interactive Generation of figures) is a
  23.           screen-oriented tool which  allows  the  user  to  draw  and
  24.           manipulate  objects  interactively.  Various versions of Fig
  25.           run under the Suntools/Sunview window environment and  under
  26.           version  11  of the X Windows System.  Fig2dev is compatible
  27.           with Fig versions 1.3, 1.4, 2.0, 2.1, 3.0 and 3.1.
  28.  
  29.  
  30.      OOPPTTIIOONNSS
  31.           --LL   Set the output graphics language.  Valid languages  are
  32.                bbooxx,,  eeppiicc,,  eeeeppiicc,,  eeeeppiicceemmuu,, iibbmmggll,, llaatteexx,, nnuullll,, ppiicc,,
  33.                ppiicctteexx,, ppss,, ppsstteexx,, ppsstteexx__tt,, tteexxttyyll,, mmff  ((MMEETTAAFFOONNTT))  and
  34.                ttppiicc..
  35.  
  36.           --mm   Set  the  magnification at which the figure is rendered
  37.                to _m_a_g_.  The default is 1.0.
  38.  
  39.           --ff   Set the default font used for  text  objects  to  _f_o_n_t_.
  40.                The default is Roman; the format of this option depends
  41.                on the graphics _l_a_n_g_u_a_g_e in  use.   In  TeX-based  lan-
  42.                guages,  the  font  is  the  base  of the name given in
  43.                lfonts.tex, for instance "cmr" for Roman, or  "tt"  for
  44.                teletype.   In PostScript, it is any font name known to
  45.                the printer or interpreter.
  46.  
  47.           --ss   Set the default font size (in points) for text  objects
  48.                to _f_s_i_z_e_.  The default is 11*mag, and thus is scaled by
  49.                the --mm option.  If there is  no  scaling,  the  default
  50.                font is eleven point Roman."
  51.  
  52.           --VV   Print the program version number only.
  53.  
  54.           _o_t_h_e_r _o_p_t_i_o_n_s
  55.                The  other options are specific to the choice of graph-
  56.                ics _l_a_n_g_u_a_g_e_, as described below.
  57.  
  58.  
  59.      EEPPIICC OOPPTTIIOONNSS
  60.           EPIC is an enhancement to LaTeX picture drawing environment.
  61.  
  62.  
  63.  
  64.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      FIG2DEV(1)                                             FIG2DEV(1)
  71.  
  72.  
  73.           It  was  developed  by Sunil Podar of Department of Computer
  74.           Science in S.U.N.Y at Stony Brook.
  75.  
  76.           EEPIC is an extension to  EPIC  and  LaTeX  picture  drawing
  77.           environment  which  uses  tpic specials as a graphics mecha-
  78.           nism.  It was written by Conrad Kwok of Division of Computer
  79.           Science at University of California, Davis.
  80.  
  81.           EEPIC-EMU  is  an EEPIC emulation package which does not use
  82.           tpic specials.
  83.  
  84.           --ll   Use "\\tthhiicckklliinneess" when width of the line is wider  than
  85.                _l_w_i_d_t_h_.  The default is 2.
  86.  
  87.           --vv   Include comments in the output file.
  88.  
  89.           --PP   Generate  a  complete  LaTeX  file. In other words, the
  90.                output file can  be  formatted  without  requiring  any
  91.                changes.  The additional text inserted in the beginning
  92.                and at the end of the file is controlled by the config-
  93.                uration parameter "Preamble" and "Postamble".
  94.  
  95.           --SS   Set  the  scale  to which the figure is rendered.  This
  96.                option automatically sets the _m_a_g_n_i_f_i_c_a_t_i_o_n and size to
  97.                _s_c_a_l_e / 12 and _s_c_a_l_e respectively.
  98.  
  99.           --WW   Enable variable line width
  100.  
  101.           --ww   Disable  variable line width. Only "\\tthhiicckklliinneess" and/or
  102.                "\\tthhiinnlliinneess" commands will be generated in  the  output
  103.                file.
  104.  
  105.           When  variable  line  width  option is enabled, "\\tthhiinnlliinneess"
  106.           command  is  still  used  when  line  width  is  less   than
  107.           _L_i_n_e_T_h_i_c_k.  One  potential  problem  is  that  the  width of
  108.           "\\tthhiinnlliinneess" is 0.4pt but the resolution of Fig is 1/80 inch
  109.           (approx.  1pt).  If _L_i_n_e_T_h_i_c_k is set to 2, normal lines will
  110.           be drawn in 0.4pt wide lines but  the  next  line  width  is
  111.           already  2pt. One possible solution is to set _L_i_n_e_T_h_i_c_k to 1
  112.           and set the width of the those lines you want to be drawn in
  113.           "\\tthhiinnlliinneess"  to 0.
  114.  
  115.           Due  to  this  problem,  Variable  line  width  _V_a_r_W_i_d_t_h  is
  116.           defaulted to be false.
  117.  
  118.  
  119.      IIBBMM--GGLL OOPPTTIIOONNSS
  120.           IBM-GL (International Business Machines  Graphics  Language)
  121.           is  compatible  with  HP-GL  (Hewlett-Packard  Graphics Lan-
  122.           guage).
  123.  
  124.           --aa   Select ISO A4 (ANSI A) paper size  if  the  default  is
  125.                ANSI A (ISO A4) paper size.
  126.  
  127.  
  128.  
  129.  
  130.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      FIG2DEV(1)                                             FIG2DEV(1)
  137.  
  138.  
  139.           --cc   Generate  instructions  for  an  IBM 6180 Color Plotter
  140.                with (without) an IBM  Graphics  Enhancement  Cartridge
  141.                (IBM-GEC).
  142.  
  143.           --dd   Restrict  plotting to a rectangular area of the plotter
  144.                paper which has a lower left hand corner  at  _(_x_l_l_,_y_l_l_)
  145.                and  a  upper right hand corner at _(_x_u_r_,_y_u_r_)_.  All four
  146.                numbers are in inches and follow --dd in a comma-sparated
  147.                list - _x_l_l_,_y_l_l_,_x_u_r_,_y_u_r - with no spaces between them.
  148.  
  149.           --ff   Load  text  character  specifications from the table in
  150.                the _f_o_n_t_s file.  The table must have 36 entries  -  one
  151.                for each font plus a default.  Each entry consists of 5
  152.                numbers which specify the 1.) standard character set (0
  153.                -  4, 6 - 9, 30 - 39), 2.) alternate character set (0 -
  154.                4,  6  -  9,  30  -  39),  3.)  character  slant  angle
  155.                (degrees),  4.)  character  width  scale factor and 5.)
  156.                character height scale factor.
  157.  
  158.           --ll   Load area fill line patterns from the table in the _p_a_t_-
  159.                _t_e_r_n_s  file.   The table must have 21 entries - one for
  160.                each of the area fill patterns.  Each entry consists of
  161.                5  numbers  which  specify the 1.) pattern number (-1 -
  162.                6), 2.) pattern length (inches), 3.) fill type (1 - 5),
  163.                4.) fill spacing (inches) and 5.) fill angle (degrees).
  164.  
  165.           --mm   The magnification may appear as the first element in  a
  166.                comma sepatated list - _m_a_g_,_x_0_,_y_0 - where the second and
  167.                third parameters specify an offset in inches.
  168.  
  169.           --pp   Load plotter pen specifications from the table  in  the
  170.                _p_e_n_s  file.   The  table  must have 9 entries - one for
  171.                each color plus a default.  Each entry  consists  of  2
  172.                numbers  which  specify  the 1.) pen number (1 - 8) and
  173.                2.) pen thickness (millimeters).
  174.  
  175.           --PP   Rotate the figure to  portrait  mode.  The  default  is
  176.                landscape mode.
  177.  
  178.           --SS   Set the pen speed to _s_p_e_e_d (centimeters/second).
  179.  
  180.           --vv   Plot  the  figure upside-down in portrait mode or back-
  181.                wards in landscape mode.  This allows you to  write  on
  182.                the top surface of overhead transparencies without dis-
  183.                turbing the plotter ink on the bottom surface.
  184.  
  185.           Fig2dev may be installed  with  either  ANSI  A  or  ISO  A4
  186.           default  paper  size.   The  --aa option selects the alternate
  187.           paper size.  Fig2dev does not fill closed splines.  The IBM-
  188.           GEC  is  required  to  fill  other polygons.  Fig2dev may be
  189.           installed for plotters with or without the IBM-GEC.  The  --cc
  190.           option selects the alternate instruction set.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      FIG2DEV(1)                                             FIG2DEV(1)
  203.  
  204.  
  205.      LLAATTEEXX OOPPTTIIOONNSS
  206.           --ll   Sets  the  threshold between LaTeX thin and thick lines
  207.                to _l_w_i_d_t_h pixels.  LaTeX supports  only  two  different
  208.                line width: \thinlines and \thicklines.  Lines of width
  209.                greater than _l_w_i_d_t_h pixels are  drawn  as  \thicklines.
  210.                Also  affects  the  size  of dots in dotted line style.
  211.                The default is 1.
  212.  
  213.           --dd   Set a separate magnification for  the  length  of  line
  214.                dashes to _d_m_a_g_.
  215.  
  216.           --vv   Verbose mode.
  217.  
  218.           LaTeX  cannot  accurately represent all the graphics objects
  219.           which can be described by Fig.  For  example,  the  possible
  220.           slopes which lines may have are limited.  Some objects, such
  221.           as spline curves, cannot be drawn at all.  Fig2latex chooses
  222.           the  closest  possible line slope, and prints error messages
  223.           when objects cannot be drawn accurately
  224.  
  225.  
  226.      PPIICC OOPPTTIIOONNSS
  227.           --pp   Enables the use of certain  PIC  extensions  which  are
  228.                known  to  work  with  the groff package; compatibility
  229.                with DWB PIC is unknown.   The  extensions  enabled  by
  230.                each option are:
  231.  
  232.  
  233.           aarrcc  Allow ARC_BOX i.e. use rounded corners
  234.  
  235.           lliinnee Use the 'line_thickness' value
  236.  
  237.           ffiillll Allow ellipses to be filled
  238.  
  239.           aallll  Use all of the above
  240.  
  241.           ppssffoonntt
  242.                Don't convert Postscript fonts generic type (useful for
  243.                files going to be Ditroff'ed  for  and  printed  on  PS
  244.                printer). DWB-compatible.
  245.  
  246.           aallllppss
  247.                Use all of the above (i.e. "all" + "psfont")
  248.  
  249.  
  250.      PPIICCTTEEXX OOUUTTPPUUTT
  251.           In  order  to include PiCTeX pictures into a document, it is
  252.           necessary to load the PiCTeX macros.
  253.  
  254.           PiCTeX uses TeX  integer  register  arithmetic  to  generate
  255.           curves,  and  so  it  is  very slow.  PiCTeX draws curves by
  256.           \\ppuutt-ing the _p_s_y_m_b_o_l repeatedly, and  so  requires  a  large
  257.           amount  of  TeX's  internal  memory, and generates large DVI
  258.           files.  The size of TeX's memory limits the number  of  plot
  259.  
  260.  
  261.  
  262.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      FIG2DEV(1)                                             FIG2DEV(1)
  269.  
  270.  
  271.           symbols in a picture.  As a result, it is best to use PiCTeX
  272.           to generate small pictures.
  273.  
  274.  
  275.      PPOOSSTTSSCCRRIIPPTT OOPPTTIIOONNSS
  276.           With PostScript, Fig can be used to  create  large  posters.
  277.           The  figure will be created by printing multiple pages which
  278.           can be glued together.  Simply specify the -M option to pro-
  279.           duce a multi-page output.  Due to memory limitations of most
  280.           laser printers, the figure should not  be  too  complicated.
  281.           Great for text with very big letters.
  282.  
  283.           Text can now include various ISO-character codes above 0x7f,
  284.           which is useful  for  language  specific  characters  to  be
  285.           printed directly.  Not all ISO-characters are implemented.
  286.  
  287.           Color support: Colored objects created by Fig can be printed
  288.           on a color postscript printer. There are 32 standard colors:
  289.           black, yellow, white, gold, five shades of blue, four shades
  290.           of green, four shades of cyan,  four  shades  of  red,  five
  291.           shades  of magenta, four shades of brown, and four shades of
  292.           pink.  In addition there may be user-defined colors  in  the
  293.           file.   See  the  xfig  FORMAT3.1 file for the definition of
  294.           these colors.  On a monochrome printer, colored objects will
  295.           be  mapped into different grayscales by the printer.  Filled
  296.           objects are printed using the given  area  fill  and  color.
  297.           There are 21 "shades" going from black to full saturation of
  298.           the fill color, and 21 more "tints" from full saturation + 1
  299.           to  white.   In  addition,  there  are  16  patterns such as
  300.           bricks, diagonal lines, crosshatch, etc.
  301.  
  302.           --cc   option centers the figure on the page.   The  centering
  303.                may  not be accurate if there are texts in the _f_i_g___f_i_l_e
  304.                that extends too far to the right of other objects.
  305.  
  306.           --ee   option puts the figure against the edge (not  centered)
  307.                of the page.
  308.  
  309.           --ll dduummmmyy__aarrgg
  310.                Generate  figure in landscape mode.  The dummy argument
  311.                is ignored, but must appear on  the  command  line  for
  312.                reasons  of  compatibility.   This option will override
  313.                the orientation specification in  the  file  (for  file
  314.                versions 3.0 and higher).
  315.  
  316.           --MM   Generate multiple pages if figure exceeds page size.
  317.  
  318.           --pp dduummmmyy__aarrgg
  319.                Generate  figure  in portrait mode.  The dummy argument
  320.                is ignored, but must appear on  the  command  line  for
  321.                reasons  of  compatibility.   This option will override
  322.                the orientation specification in  the  file  (for  file
  323.                versions  3.0 and higher).  This is the default for Fig
  324.                files of version 2.1 or lower.
  325.  
  326.  
  327.  
  328.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      FIG2DEV(1)                                             FIG2DEV(1)
  335.  
  336.  
  337.           --PP   indicates that the figure describes a full  page  which
  338.                will  not  necessarily be inserted into a document, but
  339.                can be sent directly to a  PS  printer.   This  ensures
  340.                that  a  showpage command is inserted at the end of the
  341.                figure.
  342.  
  343.           --nn nnaammee
  344.                Set the Title part of the PostScript  output  to  _n_a_m_e_.
  345.                This  is  useful  when  the input to _f_i_g_2_d_e_v comes from
  346.                standard input.
  347.  
  348.           --xx ooffffsseett
  349.                shift the figure in the X  direction  by  _o_f_f_s_e_t  units
  350.                (1/72 inch).  A negative value shifts the figure to the
  351.                left and a positive value to the right.
  352.  
  353.           --yy ooffffsseett
  354.                shift the figure in the Y  direction  by  _o_f_f_s_e_t  units
  355.                (1/72 inch).  A negative value shifts the figure up and
  356.                a positive value down.
  357.  
  358.           --zz ppaaggeessiizzee
  359.                Sets the pagesize. Available page  sizes  are  "Letter"
  360.                (8.5" x 11"), "Legal" (11" x 14") "Ledger" (11" x 17"),
  361.                "A4" (21cm x 29.7cm), and "B5" (18.2cm x 25.7cm).
  362.  
  363.  
  364.  
  365.      PPSSTTEEXX OOPPTTIIOONNSS
  366.           The  ppsstteexx language is a variant of ppss which suppresses for-
  367.                matted  (special)  text.   The ppsstteexx__tt language has the
  368.                complementary behavior: it generates  only  LaTeX  com-
  369.                mands  necessary to position special text, and to over-
  370.                lay the PostScript file generated using  ppsstteexx..   These
  371.                two drivers can be used to generate a figure which com-
  372.                bines the flexibility of PostScript graphics with LaTeX
  373.                text formatting of special text.
  374.  
  375.           The  ppsstteexx__tt  option  --pp  ffiillee  specifies  the  name  of the
  376.                PostScript file to be overlaid.   If  not  set  or  its
  377.                value is null then no PS file will be inserted.
  378.  
  379.  
  380.  
  381.      TTEEXXTTYYLL OOPPTTIIOONNSS
  382.           There are no TeXtyl-specific options.
  383.  
  384.  
  385.      MMEETTAAFFOONNTT OOPPTTIIOONNSS
  386.           --CC ccooddee
  387.                specifies the starting METAFONT font code.
  388.  
  389.           --nn nnaammee
  390.                specifies the name to use in the output file.
  391.  
  392.  
  393.  
  394.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      FIG2DEV(1)                                             FIG2DEV(1)
  401.  
  402.  
  403.           --pp ppeenn
  404.                specifies the size of the METAFONT pen.
  405.  
  406.           --tt ttoopp
  407.                specifies the top of the whole coordinate system.
  408.  
  409.           --xx xxnneegg
  410.                specifies  the minimum x coordinate value of the figure
  411.                (inches).
  412.  
  413.           --yy yynneegg
  414.                specifies the minumum y coordinate value of the  figure
  415.                (inches).
  416.  
  417.           --XX xxppooss
  418.                specifies  the maximum x coordinate value of the figure
  419.                (inches).
  420.  
  421.           --YY yyppooss
  422.                specifies the maximum y coordinate value of the  figure
  423.                (inches).
  424.  
  425.  
  426.  
  427.      TTPPIICC OOPPTTIIOONNSS
  428.           There are no tpic-specific options.
  429.  
  430.  
  431.      SSEEEE AALLSSOO
  432.           [x]fig(1), pic(1) pic2fig(1), transfig(1)
  433.  
  434.      CCOOPPYYRRIIGGHHTT
  435.           Copyright (c) 1985 Supoj Sutantavibul
  436.           Copyright (c) 1991 Micah Beck
  437.  
  438.           Permission  to  use, copy, modify, distribute, and sell this
  439.           software and its documentation for  any  purpose  is  hereby
  440.           granted  without  fee,  provided  that  the  above copyright
  441.           notice appear in all copies and  that  both  that  copyright
  442.           notice and this permission notice appear in supporting docu-
  443.           mentation. The authors make  no  representations  about  the
  444.           suitability  of  this  software for any purpose.  It is pro-
  445.           vided "as is" without express or implied warranty.
  446.  
  447.           THE AUTHORS DISCLAIM ALL  WARRANTIES  WITH  REGARD  TO  THIS
  448.           SOFTWARE,  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABIL-
  449.           ITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
  450.           ANY  SPECIAL,  INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAM-
  451.           AGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  452.           WHETHER  IN  AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TOR-
  453.           TIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH  THE  USE
  454.           OR PERFORMANCE OF THIS SOFTWARE.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      FIG2DEV(1)                                             FIG2DEV(1)
  467.  
  468.  
  469.      AAUUTTHHOORRSS
  470.           Micah Beck
  471.           Cornell University
  472.           Sept 28 1990
  473.  
  474.           and Frank Schmuck (then of Cornell University)
  475.           and Conrad Kwok (then of U.C. Davis).
  476.  
  477.           drivers contributed by
  478.           Jose Alberto Fernandez R. (U. of Maryland)
  479.           and Gary Beihl (MCC)
  480.  
  481.           Color support, ISO-character encoding and poster support by
  482.           Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
  483.  
  484.           Modified from f2p (fig to PIC), by the author of Fig
  485.           Supoj Sutanthavibul (supoj@sally.utexas.edu)
  486.           University of Texas at Austin.
  487.  
  488.           MetaFont driver by
  489.           Anthony Starks (ajs@merck.com)
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                 Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          8
  527.  
  528.  
  529.